docs(cosh-ng): [gateway] define ACP design - #2498
Draft
kongche-jbw wants to merge 3 commits into
Draft
Conversation
github-actions
Bot
added
component:cosh-ng
kongche-jbw
force-pushed
the
feat/cosh-ng/acp-architecture-rfc
branch
from
August 13, 2026 09:05
f4e0653 to
bd878ff
Compare
kongche-jbw
changed the title
- Define the Gateway, Task, Runtime, and OS governance boundaries. - Adopt ACP wire v1 as the replaceable Agent Runtime interface. - Establish Rust 1.88 and contribution rules for shared development. Signed-off-by: kongche-jbw <kongche.jbw@alibaba-inc.com>
kongche-jbw
force-pushed
the
feat/cosh-ng/acp-architecture-rfc
branch
from
August 13, 2026 09:56
bd878ff to
1829874
Compare
2 tasks
- Add bilingual task, durability, capability, security, and adapter designs. - Separate target architecture from current implementation status. - Define community-facing invariants and acceptance boundaries. Signed-off-by: kongche-jbw <kongche.jbw@alibaba-inc.com>
4 tasks
- Define portable and ws-ckpt capability profiles. - Keep target selection trusted and fail closed. - Split implementation into reviewable acceptance slices. Signed-off-by: kongche-jbw <kongche.jbw@alibaba-inc.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
cosh-ng is evolving from an interactive Shell into a local-first Agent
operations gateway. A public architecture baseline is needed so contributors
can evolve the Task Plane, Runtime ports, governed execution, and adapter
conformance without creating parallel lifecycle or authorization models.
What changed
Runtime security, and adapter conformance contracts.
task-only-v1and Linuxws-ckpt-v1capability profiles,with trusted provider registration and no silent fallback.
acceptance slices.
acceptance evidence.
This PR remains documentation-only. Implementation is being prepared as a
separate Draft PR so architecture review and code review can proceed
independently.
Related issue
no-issue: establish the shared ACP architecture for community development
User / Agent impact
None. This change defines architecture and contribution contracts; it does not
change installed behavior.
Risk and compatibility
The documents define long-lived boundaries rather than enabling behavior. ACP
remains a Runtime interoperability protocol; Task durability and governed OS
execution remain COSH-owned contracts.
ws-ckptis the first governed target,not a permanent Gateway dependency. The current implementation remains fixed
to the checkpoint-enabled slice until portable profile admission is implemented
and accepted.
Validation
bash scripts/docs-lint.shpython3 scripts/docs-link-check.pygit diff --checkNo Cargo checks were run because this is a documentation-only change.
Documentation and rollback
Adds eight bilingual design groups under
src/cosh-ng/docs/design/acp-gateway/. Revert the documentation commits toremove the architecture baseline; no runtime state, package, or protocol
migration is involved.